This appendix describes how to use the Content Filtering Customer Care Interface (CF-CCI) to provide customer support, and the Report Engine (RE) to generate subscriber usage reports.
Content Filtering CCI is a Web-based GUI interface to provide information to support staff in the operator’s customer-care support center. Customer care staff can provide support and solutions to subscribers who are having problems with the content filtering results and policies associated with their account.
IMPORTANT: For information on system requirements for a client workstation to access CF Customer Care Interface server through HTTP, refer to the CF Customer Care Interface Client Recommendations section in the Content Filtering Support Overview chapter.https://cci_installation_server or IP_address:HTTPS Port/cci/login.jsp
Where cci_instalation_server:port is the IP address/host name and port number of the CCI server where the CF-CCI server application is installed. The server IP address must be entered in dotted-decimal notation.
|
2
|
In the User Name text box, enter the user name.
|
|
3
|
In the Password text box, enter the password.
|
|
4
|
Click Login.
|
IMPORTANT: The CCI application supports secure access, which displays security alerts when users access the “login.jsp” for the first time. If users accept and install the security certificate on their machines, the security alert message is not displayed the next time they access the “login.jsp” page.|
1
|
Click the “Add User” link. The “Add User” screen is displayed.
|
|
2
|
In the User Name text box, enter the user’s name.
|
|
3
|
In the Password text box, enter a password for the user.
|
|
4
|
In the Confirm Password text box, re-enter the password.
|
|
5
|
In the Privilege list, select the user’s privilege level.
|
|
6
|
To save the user account, click Add. A confirmation message is displayed.
|
|
1
|
In the User Name column, select the user, then click the Modify link for the user. The Modify User screen is displayed.
|
|
2
|
In the Old Password text box, enter the user’s old/current password.
|
|
3
|
In the New Password text box, enter a new password for the user.
|
|
4
|
In the Confirm New Password text box, re-enter the new password for the user.
|
|
5
|
To change the user’s privilege, select the Privilege check box, then in the list, select the privilege.
|
|
6
|
To save the changes, click Modify. A confirmation message is displayed.
|
|
1
|
In the User Name column, select the user account that you want to delete, and click the Delete link for the user. A confirmation message is displayed.
|
To access the URL Rating page, click the URL Rating link available in the left navigation pane of the CF-CCI main page. The following screen is displayed.
|
1
|
In the URL text box, enter the URL with proper syntax and notations.
|
|
2
|
Click Classify Now button. The CCI system displays the URL category information in the Category field.
|
IMPORTANT: If queried URL is not categorized in Optimized Content rating Master Database (OPTCMDB) the CF-CDP server will return “None” as category for the queried URL and in case asked URL is missing from OPTCMDB the CF-CDP will return “Undefined” as category for this.To access the “URL History” page, click the Site History link available in the left navigation pane of the CF-CCI main page. The following screen is displayed.
This interface allows the user to view the list of URLs accessed by the subscriber. Use the following procedure to access the list of URLs accessed by the subscriber.
|
1
|
In the Subscriber ID text box, enter the subscriber’s MN/IMSI/MSID.
|
The subscriber ID must be a maximum of 16 characters in length. Additionally, you can enter the network access identifier (NAI) in the Network Access Identifier text box.
|
2
|
To select the duration and narrow the search results, select the Date/Time Since check box.
|
|
4
|
Select the search criteria in the Search by section of the screen by selecting the check box for each search criteria, and entering/selecting the needed value across the field. The individual search criteria are optional.
|
The following is the list of search criteria in the Internet Site Access History section of the screen:
|
l
|
URL: Enter the URL string with maximum allowed length of “URL” in text field of 4096 characters.
|
|
l
|
Category List: The category list contains multiple elements for URL or content rating. Some of the categories are:
|
|
l
|
|
l
|
See the Category List appendix for the list of categories and their description.
|
l
|
Action List: The action list contains multiple elements to provide action on content or URL. Following are the available actions for a content or URL providing content on the basis of configurations:
|
|
l
|
|
l
|
|
l
|
Rating List: The rating list contains two elements, Static or Dynamic.
|
|
5
|
Select the duration by enabling the Date/Time Since check box to narrow the search result. On enabling this check box the Calendar tool is displayed. In the Calendar tool select the date and time to display all the URLs accessed by the user since specified date and time.
|
|
6
|
Click Pick Date/Time button to accept the date and time selected.
|
|
7
|
In the Time Zone combo-box, select the time zone.
|
|
8
|
After entering the search criteria, click the Search button. If the site history is present for the entered Subscriber ID with matching search criteria, the CF-CCI system displays the list of URLs accessed. See the following figure for a sample.
|
The following table describes the fields in the “List of URLs Accessed” table of the CCI subscriber site history page.
|
This label specifies the CF subscriber’s identification or NAI whose list of visited URLs is queried.
|
|
|
Max. URLs to be displayed
|
Specifies the maximum number of URLs can be displayed in one page of “List of URLs Accessed” table.
|
|
Specifies the number of URLs displayed in “List of URLs Accessed” table for this Subscriber ID.
|
|
|
Represent the time the URL was accessed by the subscriber on the date specified by the Date column.
|
The Report Generator utility in CF-CDP is a script based tool responsible for report generation and EDR parsing. A script-based utility generates reports in XML format for content filtering subscribers and report engine server takes care of EDR parsing.
These reports can also be generated from the WEM GUI. For more information, refer to WEM Online Help.
IMPORTANT: Data from CF-System in the form of EDR files are fetched, parsed, and stored in database at CF-CDP server. It is mandatory that EDR files must contain following fields to generate EDR reports through Report Generator:sn-start-time
radius-calling-station-id OR radius-user-name
sn-cf-category-rating-type
sn-cf-category-classification-used
sn-cf-category-flow-action
sn-cf-category-policy
sn-cf-category-unknown-url
If these mentioned fields are missing from the header of EDR file, Report Generator will skip those EDR files for report generation purpose.
xmlGenerator --s <StartDate> --e <EndDate> --t <1|2|3> --i <IMG-Name> --n <NAI> --d <SCBRID> --u <URL-Path>
xmlGenerator -startdate <StartDate> -enddate <EndDate> -reporttype <1|2|3> -img <IMG-Name> -nai <NAI> -scbrid <SCBRID> -url <URL-Path>
|
Refer to Figure C-4 for a sample of Overall Summary Report.
Description: This is a very fine level of reporting in which you will get detailed information about each URL, when it was visited, etc.
Refer to Figure C-5 for a sample of Subscriber Detail Report.
Description: This is a higher level of report which will show how many times the URL was visited. This is a mandatory parameter.
Refer to Figure C-6 for a sample of URL Summary Report.
|
|
|
Specify the absolute path of file containing list of URLs. This is mandatory for URL Summary Report.
|
The following figure shows a sample Overall Summary Report generated using the Report Generator tool.
The following figure shows a sample of the Subscriber Detailed Report generated using the Report Generator tool.
The following figure displays a sample URL Summary Report generated using the Report Generator tool.
For descriptions of these reports, see the Report Engine (RE) section in the Content Filtering Support Overview chapter.
The Report Generator stores the generated reports in the /report directory of the cdp_base_directory with the following naming convention:
|
l
|
ReportType: This report type can be any one of the following:
|
|
l
|
OverallSummary: For Overall Summary Report
|
|
l
|
SubscriberDetail: For Subscriber Detailed Report
|
|
l
|
URLSummary: For URL Summary Report
|
|
l
|
ReportGenerationDate: Report generation date in UNIX or POSIX format.
|
|
l
|
ReportGenerationTime: Report generation time in UNIX or POSIX format, i.e. in hr:min:sec.millilsec format.
|
